package cn.gok.client.service;

import cn.gok.common.entity.adress.Area;
import cn.gok.common.entity.adress.City;
import cn.gok.common.entity.adress.Province;

import java.util.List;

/**
 * @author: shikundai
 * @Date: 2020/10/20
 * @Time: 15:29
 * @description: 省份、城市、区域的持久化层
 */
public interface AdressSercice {
    /**
     * 描述: 获取所有的省份
     *
     * @return 省份集合
     * @author shikundai
     * @date 2020/10/20
     * @time 15:32
     */
    public List<Province> getAllProvince();

    /**
     * 描述:通过省份ID获得省份信息
     *
     * @param provinceId
     * @return 省份信息
     * @author shikundai
     * @date 2020/10/20
     * @time 17:03
     */
    public Province getProvince(String provinceId);

    /**
     * 描述: 通过省份ID获得该省份的城市
     *
     * @param provinceId 省份ID
     * @return 城市集合
     * @author shikundai
     * @date 2020/10/20
     * @time 16:23
     */
    public List<City> getCityByProvinceId(String provinceId);
    /**
     * 描述:通过城市Id获得城市信息
     * @author shikundai
     * @date 2020/10/20
     * @time 17:05
     * @param cityId
     * @return  城市对象
     */
    public City getCity(String cityId);
    /**
     * 描述:通过城市ID获得它的区域
     * @author shikundai
     * @date 2020/10/20
     * @time 16:28
     * @param cityId 城市ID
     * @return 区域集合
     */
    public List<Area> getAreaByCityId(String cityId);
    /**
     * 描述:通过区域Id获得区域信息
     * @author shikundai
     * @date 2020/10/20
     * @time 17:06
     * @param areaId
     * @return 区域对象
     */
    public Area getArea(String areaId);
}
